home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Misc / SciCalc1.1 / README
Text File  |  1996-01-08  |  11KB  |  247 lines
  1. ======================================================================
  2.  
  3. This   is the  source  only  distribution  of the  SciCalc Version 1.1
  4. application.  SciCalc is a  more richly featured  version of the basic
  5. Calculator example program from which it was spawned from.  SciCalc is
  6. distributed  under the GNU copy-left   Free Software conditions.  This
  7. supersedes any distrubution conditions  mentioned in the  applications
  8. Help panel.  SciCalc requires NextStep 2.0 or greater to run.
  9.  
  10. ======================================================================
  11.  
  12.                 SciCalc - Help
  13.  
  14. SciCalc is a push button calculator that supports many of the features
  15. found on your average buck $2.98 scientific pocket calculator.
  16.  
  17. EXPRESSION SYNTAX:
  18.  
  19.    SciCalc processes   mathematical expressions in   a  normal left to
  20. right order  while  taking  into  account  operator  precedence.   For
  21. example   SciCalc  evaluates "1  +  2  * 3" to  be   equal to 7.  Each
  22. expression is displayed just as it is entered in the upper LCD window.
  23. When the  Equals [=]  button   is pressed  the  entered  expression is
  24. evaluated and  the display is replaced  by the result.   If an invalid
  25. expression is formed SciCalc will display  the "<Syntax Error>" string
  26. which prohibits further  operation until the  All Clear [AC] button is
  27. pressed.
  28.  
  29. OPERATORS AND FUNCTIONS:
  30.  
  31.   SciCalcs expressions are formed as a sequence of values separated by
  32. operators and  values preceeded by  functions.  Operators  include the
  33. basic Plus  [+],   Minus [-],  Multiply  [x],  and   Divide [/].   All
  34. operators must  be  preceeded by and followed   by either  an explicit
  35. value or a function request.  Other operators include the [X^Y] and [X
  36. Root  of Y]  buttons.  Function  requests  are  made by  pressing  the
  37. desired function  key  followed  by  a   value or an  expression    in
  38. parenthesis.  Examples of Function keys include the [sin], [10^x], and
  39. [X!]   buttons.   As an  example the  key  sequence for   entering the
  40. following expression would be:
  41.  
  42.     sin (23 - 5^(3.1*2.5)) / (11-5*4) 
  43.  
  44.     Press [sin] then [(] then [2] then [3] then [-] then [5] then [X^Y] then
  45.     [(] then [3] then [.] then [1] then [*] then [2] then [.] then [5] then
  46.     [)] then [)] then [/] then  [(] then [1] then [1] then [-] then [5] then
  47.     [*] then [4] then [)] and finally [=].
  48.  
  49.  
  50. MODIFIED FUNCTIONS:
  51.  
  52.    Not  all available functions have  a  unique button.  Most function
  53. buttons can be altered via the modifer toggle buttons [Hyperbolic] and
  54. [Inverse].  The following table lists  each button that has a modified
  55. function.  The H's  and I's in  the modifier column indicates that the
  56. Hyperbolic  and Inverse   toggle buttons  must  be  set to access  the
  57. function.
  58.  
  59.         Button      Modifer     Function
  60.         ======        =======     ======== 
  61.         [sin]        H            sinh
  62.                            I    asin
  63.                     H      I    asinh
  64.         [cos]       H            cosh
  65.                            I       acos
  66.                     H      I        acosh                     
  67.         [tan]        H            tanh
  68.                         I       atan
  69.                     H      I        atanh
  70.         [e^x]              I        ln (natural log)
  71.         [10^x]      I       log (log base 10)
  72.         [X^y]              I        Xth root of Y
  73.         [X^2]              I        Square Root
  74.  
  75.  
  76. METRICS FOR TRIGNOMETRIC FUNCTIONS:
  77.  
  78.     The  Metric radio box determines how  to interpret the input value
  79. for the SIN, COS, and TAN functions, and what value  to return for the
  80. ASIN,  ACOS, and  ATAN  functions.   The  choices  stand for  Degrees,
  81. Radians, and Gradians.  The current  metric may be changed at anytime,
  82. and may be changed in the middle of partially entered expression.  The
  83. current  metric will  determine the  result of  any  of the previously
  84. mentioned  functions as   soon  as the   functions argument   value is
  85. determined.
  86.  
  87.  
  88. CHANGING THE NUMERIC BASE
  89.  
  90.     The Base  radio box can  be used to  change the  operating numeric
  91. base between Decimal, Hexidecimal, Octal, and Binary.  When in decimal
  92. mode all values are expressed in 8 byte (Quadword) units.  Hex, Octal,
  93. and Binary values can only be expressed  in 4 byte (Longword) units, 2
  94. byte  (Word)  units, or single byte  units.    When in Hex,  Octal, or
  95. Binary base the binary operators And,  Or, Not, Xor,  Lsh, and Rsh are
  96. enabled.   When the base  is changed  any  currently entered value  is
  97. replaced by  its equivalent  value in the  new base  if possible.  The
  98. value in the currently selected memory cell is also reformatted in the
  99. newly selected   base.    Each numeric   base  will  only  permit  the
  100. appopriate set of  number keys for  the selected base.  It is possible
  101. to  change the  numeric  base  in the  middle  of  an expression.  For
  102. example to add 20 Hex to 20 Octal perform the following.  First select
  103. Hex base and enter 20.   Then press the [+]  button and follow that by
  104. selecting Oct base.  Enter 20 and press the [=] button.  The result is
  105. expressed in Octal will be 60.   By selecting Decimal base result will
  106. show 48, which  should make sense  since 20 (hex)  = 32 and 20 (oct) =
  107. 16, and 32+16=48.
  108.  
  109.  
  110. CHANGING THE UNIT SIZE
  111.  
  112.     The Unit  size is  only important when   in Hexidecimal, Octal, or
  113. Binary base mode.  When in Decimal mode all values  are expressed in 8
  114. byte  Quadwords.  When in Hexidecimal,  Octal  or Binary mode the Unit
  115. size may be set to either 4 byte Longwords, 2  byte Words, or a single
  116. byte.  The  selected Unit size will determine  the value  range of the
  117. expression result.  And will determine how a value will be interpreted
  118. when changing the Base between Hex/Oct/Bin and  Dec mode.  For example
  119. if the value FF is entered while Base=Hex  and Unit=Byte, and the base
  120. is changed  to decimal the value displayed   will be -1.   If the Unit
  121. size were set to Word the displayed value would be 255.
  122.  
  123.  
  124. CHANGING FUNCTION MODE
  125.  
  126.     SciCalc provides two ways to  use the function keys.  The function
  127. mode  is toggled between   Evaluate   and   Operate modes  from    the
  128. application menu    item Function  submenu,   or  more  simply  by the
  129. Command-f keystroke.  The default method  is to evaluate functions  as
  130. part of the  entered expression.  The  alternate method is to use  the
  131. function buttons in an a operator mode.   In Operate mode the selected
  132. function takes the currently entered  value as its argument, and  then
  133. replaces the value with the result of the function.
  134.  
  135.  
  136. MEMORY FUNCTIONS:
  137.  
  138.     SciCalc provides  26   temporary memory storage  cells  labeled  A
  139. through  Z.  The currently  selected memory cell  is  indicated by the
  140. label well between the   up and down arrows  and  the memory  cell LCD
  141. window.   Different memory cells can be  selected  via the up and down
  142. arrow   buttons next to  the memory  LCD.   The up  arrow moves up the
  143. alphabet towards A, and the down arrow moves torward  Z.  The [MS] and
  144. [MR] buttons  are used to store and   recall the current  value to and
  145. from  the currently selected memory  cell.  The [MC] button will clear
  146. the value in the currenlty selected memory cell.
  147.  
  148.  
  149. BITWISE FUNCTIONS:
  150.  
  151.     The  bitwise functions  are  used to manipulate   binary data, and
  152. hence are  only  available when the  selected  Base is set  to  either
  153. Hexidecimal, Octal, or Binary.  The [And], [Or], and [Xor] buttons are
  154. binary   operators  that perform bitwise  And,    Or, and Exclusive Or
  155. operations  on the supplied operands.     The [Not], [Lsh], and  [Rsh]
  156. buttons are  actually  functions  that  perform the  bitwise  Not, the
  157. arithmetic   left  shift,   and  arithemtic   right  shift  operations
  158. respectively.
  159.  
  160.  
  161. OUTPUT PRECISON:
  162.  
  163.     The  output  of an   expressions result  may  be  modified  by the
  164. precison   slider.  When  SciCalc   is in Base   Decimal the precision
  165. setting determines how   many digits  to  print to  the right  of  the
  166. decimal  point.  If  the  current precision  setting is less  than the
  167. number of digits in the decimal  portion of the  result the value will
  168. be  displayed in exponential notation.  When  SciCalc  is in Base Hex,
  169. Octal, or  Binary mode  the  precision setting determines  the minimum
  170. number of digits to print in the result.
  171.  
  172.  
  173. KEYBOARD SHORTCUTS
  174.  
  175.     SciCalc provides various keyboard alternatives to clicking on many
  176. of the  buttons.  First and foremost are  the numeric buttons [0]-[9],
  177. [A]-[F], and [.].  Each of these buttons may be  entered by typing the
  178. corresponding key  on the main  keyboard or the  numeric  keypad.  The
  179. basic arithmetic  operators plus, minus, times,  divide can be entered
  180. by typing "+", "-", "*", and  "/" respectively.  The [=] equals button
  181. may entered by  typing "=", or by   pressing the Return  or Enter key.
  182. Typing  "(" or  ")"   are  alternatives to  clicking   the parenthesis
  183. buttons.  Typing  "~" is equivalent to pressing  the [+-] button.  The
  184. following  table lists all the  available  keyboard shortcuts that you
  185. will find impossible to remember:
  186.  
  187.     Keystroke                Function
  188.     ----------------        ------------------------
  189.     ESC                        All Clear
  190.     Delete                  Clear Entry
  191.     Ctrl-C                  COS
  192.     Ctrl-S                  SIN
  193.     Ctrl-T                  TAN
  194.     Shift-Ctrl-C            COSH
  195.     Shift-Ctrl-S            SINH
  196.     Shift-Ctrl-T            TANH
  197.     Alt-C                   ACOSH
  198.     Alt-S                   ASINH
  199.     Alt-T                   ATANH
  200.     Shift-Alt-C                ACOSH
  201.     Shift-Alt-S                ASINH
  202.     Shift-Alt-T                ATANH
  203.     "P" or "p"                Enter Pi
  204.     "["                        Memory Store
  205.     "]"                        Memory Recall
  206.     "\"                        Memory Clear
  207.     Ctrl-E                  e^x
  208.     Alt-E                   ln
  209.     Ctrl-F                  X!
  210.     Ctrl-L                  10^x
  211.     Alt-L                   LOG
  212.     Ctrl-R                  1/X
  213.     Ctrl-X                  X^2
  214.     Alt-X                   Square Root
  215.     Ctrl-Y                  X^Y
  216.     Alt-Y                   X root Y
  217.  
  218. COPYING AND PASTING:
  219.  
  220. SciCalc supports copying  values from it's  scrolling text window.  It
  221. also allow you to  paste values into  the current expression.  Further
  222. you can  paste entire expressions-- to a  limited extent  into SciCalc
  223. and   have them evalutaed.   For example  try  copying and pasting the
  224. following expressions:
  225.     
  226.     1 + 2 * 4 =
  227.     (1 + 2) * 4 =
  228.  
  229. The equal  sign in the  expression  is equivalent  to clicking the [=]
  230. button.  Essentially all the  non-Control Keyboard  short cuts can  be
  231. part of a  pasted  expression.  For  example the  following expression
  232. will enter the value 12 for the number of inches in a foot, save it in
  233. the current memory cell then convert inches to centimeters, recall the
  234. value from the current memory cell, and finally change it's sign.
  235.     
  236.     12 [ * 2.54 = ] ~
  237.  
  238. LEGAL STUFF:
  239.  
  240.     SciCalc is free  software and may be  freely distributed under the
  241. tennets of the GNU copy-left  provisions.  Please send bug reports and
  242. any comments to the following email address:
  243.  
  244.             mdm@ringworld.inmark.com
  245.  
  246.  
  247.